Install erwin Mart Server

The Mart Server and Mart Admin war files are deployed on a Web server. You can either use an existing web server, or install the web server through the erwin MartServer 12.0 Installation Wizard. You must install erwin Mart Server and configure it regardless of whether you use Mart Server as a Windows service.

Ensure that you have reviewed the Install a Mart or Upgrade a Mart topic before proceeding.

Follow these steps:

Download the EDMMS12.0.exe file from the online erwin product page and run it.

The erwin MartServer 12.0 Installation Wizard appears.
Go through the wizard steps to install erwin Mart Server.
Depending on the options you select, erwin Mart Server and/or Oracle OpenJDK and Tomcat are installed.
From the Windows Start menu, click All Programs, erwin, Mart Server 12.0 , Configure MartServer.
The erwin Mart Configuration dialog appears.

Configure the erwin Mart Server

Complete the following fields in the Mart Server tab:
Database Connection Method
Specifies the connection method (On-Prem or Custom JDBC URL) used to connect to the Mart database. If you select Custom JDBC URL, the JDBC Connection String field appears. Enter your database connection string.
Database Type
Specifies the database server type.
Port No.
Specifies the port number of the database server.
Server Name
Specifies the name of the database server where you have installed the Mart database. For example, suppose that you are using SQL Server as the Mart database. Enter the name of the computer where SQL Server is installed.
Instance Name
Specifies the name of the database instance.
Database Name
Specifies the name of the Mart database.
If you are installing the Mart for the first time, use a new database. Do not use an existing database that was created for r7.3 through r8.2.9 Mart. If you are upgrading the Mart from any earlier release of r9 series to the latest release, use the corresponding Mart database.
User Name
Specifies the user name to connect to the Mart database. Enter the name of a user that is authenticated by the Mart database.
Windows authentication (User Name field) is not supported for connecting to the Mart database from the Configure Mart Server window.
Password
Specifies the password to connect to the Mart database.
The following fields--Domain Controller Name, Domain/User Name, and Password are required only if you are using the Active Directory authentication. You can use the Active Directory authentication to initialize the Mart and to log in to erwin Mart Administrator.
Enable SSL/Wallet
Specifies whether SSL or Wallet (in case of Oracle database) is enabled. If you select this check box for Oracle database, the following fields are enabled:
- Oracle Wallet Location: Specifies the location where you downloaded the wallet file.
- Oracle Wallet Password: Specifies the password that you set for the wallet.
Domain Controller Name
Specifies the fully qualified name of the Active Directory Server (Domain Controller). Enter the name in the following format:
```
LDAP://server/distinguished-name
```
Example: ldap://mktgna:3268/dc=abc, dc=com
Here, mktgna is the server name. You can provide either the name of the server or the IP address. 3268 is the port number to which the server listens.
dc=abc, dc=com is the distinguished-name. The distinguished name is the full path of the object.
If you do not know the Domain Controller Name, use the Nltest command or talk to your System Administrator.
Domain/User Name
Specifies the domain name and user name in the <domain name>/<user name> format.
Domain Password
Specifies the password of the domain user.
To validate connection for active directory, click Test.
You can also configure erwin Mart Server using the Command Line Interface. For example, use the following command to configure Mart Server with an Oracle database:
```
C:\Program Files\erwin\Mart Server r9\OpenJRE64\bin>java.exe -jar
 "C:\Program Files\erwin\Mart Server r9\MartUpgrade\MartConfiguration.jar"
 configure --dbuser=mmadmin --dbpwd=mmadmin --dbtype=ORACLE
 --dcname=ldap://10.1.85.94:3268/DC=test-qa,DC=com --martusessl=true
 --domainuser=test-qa\Administrator --domainpwd=interOP@123
 --dbserver=10.1.85.108 --dbport=1521 --dbinstance= 
--dbname=mart200models
```
Once you run the above command, you can verify the configuration properties in the MartConfiguration.properties file located at C:\ProgramData\erwin\Mart Server. The same properties also reflect on the Mart Server tab of the erwin Mart Configuration dialog box.

Configure erwin Mart Administrator

Enter the following information in the Mart Administrator tab:
Server Name
Specifies the name of the computer where the Web Server is present. For example, if you are using Tomcat, enter the name of the computer where Tomcat is installed.
Default: localhost
Port Number
Specifies the port number on which the Web Server is running.
Default: 18170
Application Name
Specifies the application name with which the Web Server is identified.
Default: MartServer
Secure Sockets Layer (SSL) Enabled
Specifies whether you want to connect to the Mart through a secured connection (SSL). Select this check box if you have implemented SSL.
If you use IIS with SSL, open server_ssl.xml file, which is available at C:\Program Files\erwin\Mart Server r9\Tomcat64\conf and un-comment Connector port="8009" protocol="AJP/1.3" allowedRequestAttributesPattern=".*" redirectPort="8443" secretRequired="false"/>.
Using a self-signed SSL certificate might result in an error about certificate authority while connecting to erwin Mart. In that case, click OK to continue connecting to erwin Mart.
Use IIS
Specifies whether IIS is used to run Mart Administrator. Select this check box only if you have configured IIS.
If you use IIS, open server.xml file available at C:\Program Files\erwin\Mart Server r9\Tomcat64\conf and un-comment <Connector port="8009" protocol="AJP/1.3" allowedRequestAttributesPattern=".*" redirectPort="8443" secretRequired="false"/>.
IIS Port
Specify the IIS port number that you want to use. This field is enabled only if you select the Use IIS check box. The default is 80.
Account Lockout Duration (Seconds)
Specify the duration (in seconds) for which an account should be locked whenever an incorrect password is entered five consecutive times. By default, it is set to five minutes (300 seconds). At the most, you can set it to 30 days (2592000 seconds).
Click Configure.
The erwin Mart Administrator and the Mart Server are configured.

Enable SSL for Tomcat

SSL enables you to access the Mart through a secured connection. You can enable SSL for Tomcat--the default web server, when you are installing the Mart for the first time.

Follow these steps:

If the Mart Server service is running, stop it. From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , Stop MartServer Service to stop the web server.
From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , Enable SSL for Tomcat Webserver.
SSL is enabled for Tomcat and a security certificate is created. You must install this security certificate on all the computers from where you want to access the Mart.
From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , Configure MartServer.
The erwin Mart Configuration dialog appears.
Go to the Mart Administrator tab and select the Transport Layer Security check box.
From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , Start Mart Server Service.
From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , erwin Mart Administrator 12.0 .
The erwin Mart Administrator home page appears and displays HTTPS in the address bar. If a certificate error appears, click Proceed Anyway to begin the session.

Important! If you want to connect to an SSL enabled Mart through API, you must first install the security certificate on the corresponding computer. Install the certificate through the data modeling tool. If you do not install the security certificate, the API will not be able to connect to the SSL enabled Mart.

Disable SSL and Access the Mart Through a Normal Connection

You can disable SSL at any time and access the Mart through a normal connection.

Follow these steps:

If the Mart Server Service is running, stop it. From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , Stop Mart Server Service.
From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , Disable SSL.
From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , Configure MartServer.
The erwin Mart Configuration dialog appears.
Go to the Mart Administrator tab and clear the Transport Layer Security check box.
From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , Start Mart Server Service.
From the Windows Start menu, click All Programs, erwin, erwin Mart Server 12.0 , erwin Mart Administrator 12.0 .
The erwin Mart Administrator home page appears and displays HTTP in the address bar.